home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / uhren & terminkalender / time / myclock_1_31 / myclock.guide (.txt) < prev    next >
Amigaguide Document  |  1996-04-07  |  8KB  |  211 lines

  1. @database MyClock.guide
  2. @master Prog:Programs/MyClock/MyClock1_30/MyClock.guide
  3. @$VER: MyClock.guide 1.31 (23.6.95)
  4. @wordwrap
  5. @node "Main" "MyClock v1.31"
  6.    Welcome to @{b}@{fg shine}MyClock v1.31@{ub}@{fg text}
  7.           By Marco Negri
  8.    @{"Introduction" link "Introduction" 0}
  9.    @{"Requirements" link "Requirements" 0}
  10.    @{"Usage" link "Usage" 0}
  11.      @{"From Workbench" link "FromWB" 0}
  12.      @{"From the Shell" link "FromShell" 0}
  13.    @{"ARexx Commands" link "ARexx Commands" 0}
  14.    @{"History" link "History" 0}
  15.    @{"The Author" link "Author" 0}
  16.    @{"Future" link "Future" 0}
  17.    This program is @{fg shine}CardWare@{fg text}, that is you can freely use, copy
  18.    and distribute this program. The only thing I'm asking you
  19.    is to send @{"me" link "Author" 0} a post card or a message by E-Mail, because
  20.    I'd like to see where my program is used.
  21.    Enjoy it...
  22. @endnode
  23. @node "Introduction" "Introduction"
  24.    @{b}@{fg shine}Introduction@{ub}@{fg text}
  25.    MyClock is a small program that displays a digital clock
  26.    on the screen bar of any public screen.
  27.    It is very useful because it allows you to see quickly
  28.    the time anytime and it is also very smart.
  29.    If like it, you can put it in your WBStartup drawer and
  30.    you'll always have a beautiful clock on the Workbench.
  31.    You can use it also on your favourite application screen.
  32.    These are the features of MyClock:
  33.    - Smart look. It appears in the screen bar and it seems
  34.      a built-in clock of the system.
  35.    - It can be opened on any public screen.
  36.    - It supports an optional ARexx port, allowing you to
  37.      interface MyClock with any other application (for
  38.      example you an choose to open it on the public screen
  39.      of your favourite text editor, and to force it to close
  40.      automatically (via ARexx) when quitting the editor).
  41.    - It is fully localized.
  42.    - It inherit the colors, the font and the style of the
  43.      screen in which it appears.
  44.    - Proportional fonts are fully supported.
  45.    - It is really accurate. In fact I've seen around many
  46.      clock programs not really accurate (for example the
  47.      system Clock or the wonderful DirectoryOpus).
  48.      If you try to run two or three times DOpus (if you have
  49.      enough memory) you will see that the seconds doesn't
  50.      change at the same time. If you do the same thing with
  51.      MyClock you will see perfect synchronization between
  52.      the clocks.
  53.    - It is fully 2.0, 2.1, 3.0, 3.1 compatible.
  54.    - It is very small (only 5180 bytes).
  55.    - It doesn't slow down the performance of your machine.
  56.      The CPU occupancy increase is less than 1%.
  57.    - But, above all, it's MADE BY @{"ME" link "Author" 0}.
  58. @endnode
  59. @node "Requirements" "Requirements"
  60.    @{b}@{fg shine}Requirements@{ub}@{fg text}
  61.    MyClock v1.30 works on any Amiga with OS 2.0+
  62.    It has been actually tested on:
  63.    A500 - 512K Ram - OS 2.04
  64.    A500 - 3MB Ram - 80MB Hard Disk - OS 2.04
  65.    A1200 - 2MB Ram - 80MB Hard Disk - OS 3.0
  66.    A3000 - 8MB Ram - 120MB Hard Disk - Picasso II Board - OS 3.0
  67.    A4000/030 - 4MB Ram - 120MB Hard Disk - OS 3.0
  68.    If you found some bugs or have some problems on your
  69.    configuration please contact the @{"Author" link "Author" 0}.
  70. @endnode
  71. @node "Usage" "Usage"
  72.    @{b}@{fg shine}Usage@{ub}@{fg text}
  73.    You can start the program from @{"Workbench" link "FromWB" 0} or from the @{"Shell" link "FromShell" 0},
  74.    and after you will a digital clock on the screen bar of
  75.    the selected screen.
  76.    To quit the program you have to press the left mouse button
  77.    over the clock (you will see a copyright on the screen
  78.    bar), and after you have to press the right menu button
  79.    to quit the program.
  80. @endnode
  81. @node "FromWB" "From the Workbench"
  82.    @{b}@{fg shine}From the Workbench@{ub}@{fg text}
  83.    From the Workbench the only thing you have to do is
  84.    double-clicking on the icon.
  85.    The following tooltypes are supported:
  86.    @{"SECONDS" link "Seconds" 0}
  87.    @{"DATE" link "Date" 0}
  88.    @{"DAY" link "Day" 0}
  89.    @{"12HOURS" link "12Hours" 0}
  90.    @{"SCREEN" link "Screen" 0}
  91.    @{"NOBACKDROP" link "NoBackdrop" 0}
  92.    @{"REXX" link "Rexx" 0}
  93. @endnode
  94. @node "FromShell" "From the Shell"
  95.    @{b}@{fg shine}From the Shell@{ub}@{fg text}
  96.    From the Shell the you must type the name of the program
  97.    followed by the optional arguments.
  98.    The template of the command is:
  99.    MyClock @{"SECONDS=SECS" link "Seconds" 0}/S,@{"DATE" link "Date" 0}/S,@{"DAY" link "Day" 0}/S,@{"12HOURS" link "12Hours" 0}/S,@{"NOBACKDROP" link "NoBackdrop" 0}/S,@{"SCREEN" link "Screen" 0}/K,@{"REXX" link "Rexx" 0}/K
  100. @endnode
  101. @node "Seconds" "SECONDS"
  102.    SECONDS=SECS/S:
  103.      If this option is specified then MyClock will show
  104.      also the current seconds.
  105.    DEFAULT:
  106.      By default the seconds will not be showed.
  107. @endnode
  108. @node "Date" "DATE"
  109.    DATE/S:
  110.      If this option is specified MyClock will show
  111.      also the current date of the year.
  112.      The DOS format (DD-MMM-YY) will be used).
  113.    DEFAULT:
  114.      By default the date will not be showed.
  115. @endnode
  116. @node "Day" "DAY"
  117.    DAY/S:
  118.      If this option is specified then MyClock will show
  119.      the current day of the week.
  120.      The name of the day is localized, that is it depends
  121.      on the language chosen in ENV:Sys/locale.prefs
  122.    DEFAULT:
  123.      By default the day of the week will not be showed.
  124. @endnode
  125. @node "12Hours" "12HOURS"
  126.    12HOURS/S:
  127.      If this option is specified then the time will be
  128.      showed in the AM/PM format.
  129.    DEFAULT:
  130.      By default the time is showed in 24 hours mode.
  131. @endnode
  132. @node "Screen" "SCREEN"
  133.    SCREEN/K:
  134.      If this option is specified then MyClock opens on the
  135.      named public screen.
  136.      If an asterisk '*' is specified as name, then MyClock
  137.      will open on the frontmost public screen.
  138.      If the public screen does not exist then MyClock will
  139.      open on the default public screen.
  140.    DEFAULT:
  141.      By default MyClock will open on the default public
  142.      screen (usually the Workbench).
  143. @endnode
  144. @node "NoBackdrop" "NOBACKDROP"
  145.    NOBACKDROP/S:
  146.      This option is included only for compatibility with
  147.      some applications which open a public screen and a
  148.      backdrop window covering the screen title.
  149.      As MyClock call the Intuition function:
  150.      ShowTitle (screen, FALSE);
  151.      the application window may hide the screen bar, giving
  152.      an ugly display.
  153.      This can avoided by specifying with this option.
  154.      (First try without this option, then if you have
  155.      some problems try specifying it).
  156.    DEFAULT:
  157.      By default the option is not specified.
  158. @endnode
  159. @node "Rexx" "REXX"
  160.    REXX/K:
  161.      If this option is specified then an ARexx port with
  162.      the name specified will be opened.
  163.      See the @{"list of ARexx Commands" link "ARexx Commands" 0}.
  164.    DEFAULT:
  165.      By default MyClock doesn't open any port.
  166. @endnode
  167. @node "ARexx Commands" "ARexx commands"
  168.    @{b}@{fg shine}List of ARexx Commands@{ub}@{fg text}
  169.    For the moment only one command is supported.
  170.    @{"QUIT" link "Quit" 0}
  171. @endnode
  172. @node "Quit" "QUIT"
  173.    QUIT:
  174.      This command forces MyClock to quit.
  175. @endnode
  176. @node "History" "History"
  177.   @{b}@{fg shine}History of MyClock@{ub}@{fg text}
  178.   -- v1.23 -- 23-Feb-95 --
  179.   * First official release
  180.   -- v1.30 -- 19-Apr-95 --
  181.   * ARexx port added. (Name chosen by the user)
  182.     QUIT command supported.
  183.   * NOBACKDROP option added for compatibility with
  184.     some applications.
  185.   * Improved text-length handling: minimal screen
  186.     bar occupancy.
  187.   * When specified an asterisk '*' as SCREEN, MyClock
  188.     opens on the frontmost screen.
  189.   -- v1.31 -- 23-Jun-95 --
  190.   * 12HOURS switch added.
  191. @endnode
  192. @node "Author" "The Author"
  193.    I'm a student of Economics, but in my free time I like to
  194.    program my Amiga, the best computer around.
  195.    My address is:
  196.   @{fg shine} Marco Negri
  197.    Via delle Alpi 19
  198.    20026 Novate Milanese
  199.    MILANO - Italia@{fg text}
  200.    E-Mail:
  201.    @{fg shine}s592345@vm.uni-bocconi.it@{fg text}
  202. @endnode
  203. @node "Future" "Future"
  204.    The future improvement of MyClock will be the possibility
  205.    to overrid the fonts, colors and something else of the
  206.    screen it opens into.
  207.    If you think something that it would be useful for MyClock
  208.    please let the @{"me" link "Author" 0} know, I'll be happy to implement it in
  209.    a new version and to send it to you when done.
  210. @endnode
  211.